home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / sgbtrs.z / sgbtrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          SSSSGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SGBTRS - solve a system of linear equations  A * X = B or A' * X = B with
  10.      a general band matrix A using the LU factorization computed by SGBTRF
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE SGBTRS( TRANS, N, KL, KU, NRHS, AB, LDAB, IPIV, B, LDB, INFO )
  14.  
  15.          CHARACTER      TRANS
  16.  
  17.          INTEGER        INFO, KL, KU, LDAB, LDB, N, NRHS
  18.  
  19.          INTEGER        IPIV( * )
  20.  
  21.          REAL           AB( LDAB, * ), B( LDB, * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      SGBTRS solves a system of linear equations
  25.         A * X = B  or  A' * X = B with a general band matrix A using the LU
  26.      factorization computed by SGBTRF.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      TRANS   (input) CHARACTER*1
  31.              Specifies the form of the system of equations.  = 'N':  A * X = B
  32.              (No transpose)
  33.              = 'T':  A'* X = B  (Transpose)
  34.              = 'C':  A'* X = B  (Conjugate transpose = Transpose)
  35.  
  36.      N       (input) INTEGER
  37.              The order of the matrix A.  N >= 0.
  38.  
  39.      KL      (input) INTEGER
  40.              The number of subdiagonals within the band of A.  KL >= 0.
  41.  
  42.      KU      (input) INTEGER
  43.              The number of superdiagonals within the band of A.  KU >= 0.
  44.  
  45.      NRHS    (input) INTEGER
  46.              The number of right hand sides, i.e., the number of columns of
  47.              the matrix B.  NRHS >= 0.
  48.  
  49.      AB      (input) REAL array, dimension (LDAB,N)
  50.              Details of the LU factorization of the band matrix A, as computed
  51.              by SGBTRF.  U is stored as an upper triangular band matrix with
  52.              KL+KU superdiagonals in rows 1 to KL+KU+1, and the multipliers
  53.              used during the factorization are stored in rows KL+KU+2 to
  54.              2*KL+KU+1.
  55.  
  56.      LDAB    (input) INTEGER
  57.              The leading dimension of the array AB.  LDAB >= 2*KL+KU+1.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          SSSSGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      IPIV    (input) INTEGER array, dimension (N)
  75.              The pivot indices; for 1 <= i <= N, row i of the matrix was
  76.              interchanged with row IPIV(i).
  77.  
  78.      B       (input/output) REAL array, dimension (LDB,NRHS)
  79.              On entry, the right hand side matrix B.  On exit, the solution
  80.              matrix X.
  81.  
  82.      LDB     (input) INTEGER
  83.              The leading dimension of the array B.  LDB >= max(1,N).
  84.  
  85.      INFO    (output) INTEGER
  86.              = 0:  successful exit
  87.              < 0: if INFO = -i, the i-th argument had an illegal value
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.